home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Toolbox / Visual Basic Toolbox (P.I.E.)(1996).ISO / ocx / webster / 16-bit / readme.txt < prev    next >
Text File  |  1995-08-13  |  14KB  |  335 lines
  1. WEBSTER.OCX BETA BUILD 914 For Windows NT and Windows 95    8/14/95
  2.  
  3. WEBSTER.DLL BETA BUILD 914 For Windows 3.1
  4.  
  5.                     
  6.                     The Webster OLE2 Custom Control
  7.                     -------------------------------
  8.  
  9.                    An HTML-Aware OCX From Trafalmador
  10.                    ----------------------------------
  11.  
  12.  
  13. What Is It ?
  14. ------------
  15.  
  16. The Webster OCX is a drop-in HTML display and Web browsing solution,
  17. a WWW client as an OLE control.  Webster can retrieve, interpret and
  18. display HTML pages (including forms and images), and respond to
  19. hyperlink mouse clicks.  It differs from other Web browsers in that 
  20. it is not a stand-alone application but rather a tool for application 
  21. developers.  When embedded in an OCX-capable container, Webster exposes 
  22. properties, methods and events which allow the container to maintain a 
  23. high degree of control over Webster actions.  
  24.  
  25. Using a language such as Basic, Delphi or C++, you can monitor user
  26. actions and approve, veto or replace any clicked URL.  A concealed load
  27. feature allows the container to inspect the contents of a document 
  28. before deciding whether to display it.
  29.  
  30. Browsing sessions may be fully automated for applications such as slide
  31. shows or web-walkers, or merely guided by substituting, suggesting 
  32. alternatives or disallowing access to certain URLs.  Alternatively, a 
  33. container may remain uninvolved, allowing the user to perform the usual 
  34. point-and-click Web browsing.
  35.  
  36. Possible applications include: 
  37.  
  38. o  An automated display or kiosk.
  39.  
  40. o  A Web search robot, able to perform network tree walks and retrieve
  41.    documents based on specific criteria.
  42.  
  43. o  A guided browser, which directs the user to pre-selected destinations 
  44.    yet allows side excursions inside the permitted domain.
  45.  
  46. o  An HTML reader for documents distributed on CD-ROM.
  47.  
  48. o  A Reader for an HTML forms and images database.
  49.  
  50. o  Display clickable images in any application.
  51.  
  52. o  Build a better Web browser, adding infrastructure and features 
  53.    like timer-driven events and specialized address book creation on
  54.    top of Webster's native capabilities (see Vogon Poetry).
  55.  
  56.  
  57. Who Needs It ?
  58. --------------
  59.  
  60. The target audience for Webster is the application developer who needs
  61. to incorporate a Web browser (or just an HTML display) into an 
  62. MS-Windows product, without resorting to heavyweight OLE solutions like
  63. MS-WORD.  The OCX is implemented as an in-process DLL, which is both
  64. quick and compact.  Most future program development environments will
  65. support the OCX format, which is being promoted by a very large company.
  66.  
  67. The 32-bit webster.ocx can be used under Windows NT and Windows 95 (being
  68. multithreaded, it cannot run under Win32s).  It is optimized for slow 
  69. modems.
  70.  
  71. The 16-bit webster.dll can be run under Windows 3.1x.  It differs from 
  72. the 32-bit version in that it is not (yet) net-aware, so it only accepts
  73. local "file:" URLs.
  74.  
  75.  
  76. Current State: Beta
  77. -------------------
  78.  
  79. o  32-bit multithreaded implementation / 16-bit local-only version.
  80.  
  81. o  One-click local disk browsing.
  82.  
  83. o  60+ OLE properties, methods and events exposed.
  84.  
  85. o  HTML 2.0 implemented, many 3.0 and de-facto standard extensions.
  86.  
  87. o  HTTP 1.0 protocol over winsock.
  88.  
  89. o  Can save an HTML page to disk, including images, and load from disk.
  90.  
  91. o  A simple MDI browser (Vogon Poetry) is included in the Beta kit.
  92.    Intended as a starting point for Webster-based browser development,
  93.    it demonstrates how to use Webster in an MFC/C++ app.
  94.  
  95.  
  96. Please let us know of any bugs you find or improvements you would like
  97. to see.  The beta kit may be freely redistributed.
  98.  
  99.  
  100. Installation
  101. ============
  102. The Beta kits come in 16- and 32-bit flavors, each of which has a full
  103. package and an update kit.  Download the full package only once, then
  104. just retrieve the update kit for subsequent releases.  All kits can
  105. be found at our Web page or ftp site.
  106.  
  107.  
  108. 32-bit Kit:
  109. -----------
  110. The complete distribution kit is in wbstrXXX.zip, with XXX being 
  111. the build number.  If you already have all the DLLs listed below 
  112. (they are MSVC 2.2 redistributables), you can download 
  113. wbstrXXXnodlls.zip instead.
  114.  
  115. The wbstrXXX.zip distribution kit contains the following files:
  116.  
  117. o  webster.ocx     The 32-bit Webster OCX control
  118. o  HotList.htm     Sample hotlist
  119. o  vogon32.exe     The Vogon Poetry browser
  120. o  regsvr32.exe    Use to register oc30.dll
  121. o  html.dfa        Webster data file
  122. o  html.llr        Webster data file
  123. o  mfc30.dll       SYSTEM DLL
  124. o  mfco30.dll      SYSTEM DLL
  125. o  mfcn30.dll      SYSTEM DLL
  126. o  mfcan32.dll     SYSTEM DLL
  127. o  oc30.dll        SYSTEM DLL
  128. o  msvcrt20.dll    SYSTEM DLL
  129. o  webster.odl     Declares Webster properties, events and methods
  130. o  readme.txt      This file
  131.  
  132. 16-bit Kit:
  133. -----------
  134. The complete distribution kit is in wb16-XXX.zip, with XXX being the
  135. build number.  If you already have all the DLLs listed below (they 
  136. are MSVC 1.52 redistributables), you can download wb16uXXX.zip instead.
  137.  
  138. The wb16-XXX.zip distribution kit contains the following files:
  139.  
  140. o  webster.dll     The 16-bit Webster OCX control
  141. o  vogon16.exe     The Vogon Poetry browser
  142. o  regsvr.exe      Use to register oc25.dll
  143. o  html.dfa        Webster data file
  144. o  html.llr        Webster data file
  145. o  oc25.dll        SYSTEM DLL
  146. o  compobj.dll     SYSTEM DLL (OLE 2)
  147. o  ole2.dll        SYSTEM DLL (OLE 2)
  148. o  mfcoleui.dll    SYSTEM DLL
  149. o  ole2.reg        SYSTEM DLL (OLE 2)
  150. o  ole2conv.dll    SYSTEM DLL (OLE 2)
  151. o  ole2disp.dll    SYSTEM DLL (OLE 2)
  152. o  ole2nls.dll     SYSTEM DLL (OLE 2)
  153. o  ole2prox.dll    SYSTEM DLL (OLE 2)
  154. o  stdole.tlb      SYSTEM     (OLE 2)
  155. o  storage.dll     SYSTEM DLL (OLE 2)
  156. o  typelib.dll     SYSTEM DLL (OLE 2)
  157. o  webster.odl     Declares Webster properties, events and methods
  158. o  vb_props.txt    Property list for VB3
  159. o  readme.txt      This file
  160.  
  161. Both Kits:
  162. ----------
  163. Create a directory in which to unzip the files.  After unzipping, copy
  164. all the files marked SYSTEM to your Windows system32 (32-bit) or 
  165. system (16-bit) subdirectory.  Webster.ocx (or webster.dll) may be 
  166. kept in any directory, the only strict requirement is that html.dfa 
  167. and html.llr reside in the same directory as the OCX (or DLL).
  168.  
  169. An OLE control must be entered in the system registry before it can be
  170. used.  To register webster.ocx or webster.dll, run vogon32.exe or 
  171. vogon16.exe respectively and select Register Webster from the File 
  172. menu, then select webster.ocx (or webster.dll) in the dialog box.
  173. You only need to do this once.  Note that the same menu offers an 
  174. Unregister Webster option, for complete uninstallation.  If you need 
  175. to move the OCX to a different directory, unregister it and re-
  176. register from the new location.  Remember to move html.dfa and 
  177. html.llr along with the OCX (or DLL).
  178.  
  179. You must also register oc30.dll (for webster.ocx) or oc25.dll (for
  180. webster.dll): use regsvr32.exe or regsvr.exe, respectively.  This
  181. program also has an uninstall feature.
  182.  
  183. Test the control using the Vogon Poetry browser described below.  
  184. MSVC 2.2/1.52 owners may also exercise the control using the Test 
  185. Container from the CDK (tstcon32.exe or tstcon16.exe).
  186.  
  187.  
  188. Beta Release Notes:
  189. -------------------
  190.  
  191. Beta 914: FONT and BASEFONT tag support, Tab and Enter key navigate
  192.           in forms, prompt page for basic authentication, on-the-fly
  193.           font property setting.  VB3 can now initialize properties
  194.           in Form_Load().
  195.  
  196. Beta 913: Hidden/revealed pages, basic authentication, HTTP proxy 
  197.           support, source, pure text and hyperlink extraction 
  198.           methods, load completion event, HTTP binary download.
  199.  
  200. Beta 912: Status page is automatically displayed instead of a blank
  201.           page, improved forms POST support.
  202.  
  203. Beta 911: HTTP 1.0 implemented.  Copy, cut and paste (^C, ^X and ^V)
  204.           are available in all edit controls (forms, ISINDEX).  Status
  205.           page has a dismiss-from-cache button (method will follow).
  206.           The Vogon Poetry browser now demonstrates how to handle the
  207.           DoClickURL event, which allows the container to determine 
  208.           the response to every hyperlink click.
  209.  
  210. Beta 910: Implements a status display, support for image-only pages, 
  211.           HTML source display and pure-text save.  The Vogon Poetry 
  212.           browser now has a slide show/guided tour feature.
  213.  
  214. Beta 909: Added: horizontal scroll bars.  PROMPT attribute support
  215.           for ISINDEX tags.  Direct URL entry in the directory page.
  216.           URL copy to clipboard on right mouse click.  New 16/32-bit
  217.           Vogon Poetry browser.
  218.  
  219. Beta 908: Cosmetic: improved repaint, introduction of our Web site.
  220.  
  221. Beta 907: Hyperlink jumps allowed without canceling load.  Corrected
  222.           handling of raw text files.
  223.  
  224. Beta 906: Forms fully functional, including multiple forms and multiple
  225.           Submit buttons per form.  BASE tag supported (overridable for
  226.           file: scheme via the IgnoreBaseInFile property).
  227.  
  228. Beta 905: History lists implemented.  Color selection and tiled-image
  229.           background supported.
  230.  
  231. Beta 904: ISINDEX tag supported, for simple searches.
  232.  
  233. Beta 903: A directory browsing feature has been added (the "D" button).  
  234.           Parallel 16-bit OCX is available for beta test.
  235.  
  236. Beta 902: When a control is newly created, the default setting for the 
  237.           HomePage property points to the file HotList.htm in the current
  238.           directory.  The Home button displays it.
  239.  
  240. Beta 901: The Click event has two arguments, the URL clicked by the user
  241.           and a Cancel boolean.  If the container ignores the event, the
  242.           URL is loaded.  The container can set Cancel to TRUE, causing
  243.           the user request to be ignored, or leave Cancel FALSE and 
  244.           alter the URL argument resulting in a load of the modified URL.
  245.  
  246.           The container (or user) may also initiate a page load by setting
  247.           the PageURL property.
  248.  
  249.  
  250. The Vogon Poetry Browser
  251. ------------------------
  252. The Vogon Poetry browser is not a work of art, just a quick-and-dirty
  253. demonstration platform for Webster.  It simply embeds a single Webster
  254. OCX in each MDI child window, and creates a dispatch function for 
  255. handling events.  Vogon demonstrates Webster's basic display, browsing 
  256. and event features only, and is not a full-blown OLE control container.  
  257.  
  258. Vogon Poetry exhibits the usual MDI app characteristics, including the 
  259. ability to serialize a document.  A Vogon document contains all the
  260. persistent control properties.  You can use the Webster property pages 
  261. to select the initial URL and other properties (the "W" on the Vogon 
  262. toolbar button invokes the properties dialog box), then File | Save 
  263. the configuration as a .vog document.
  264.  
  265. NEW in BETA 910: A simple slide show capability has been added to Vogon
  266. Poetry.  Select View | Slide Show Setup (or the corresponding toolbar
  267. button) to show the Slide Show Setup dialog box, then click Add to add 
  268. the current page URL to the end of the slide show list.  Toggle the 
  269. automated URL walk using View | Slide Show or the corresponding toolbar
  270. button.  When you create a .vog document (File | Save) the slide list
  271. is included, and can be reloaded with File | Open.
  272.  
  273. NEW in BETA 911: A URL filter feature demonstrates how to respond to 
  274. the DoClickURL event and approve, modify or veto the selected URL.
  275.  
  276. New in BETA 913: Added demos for hidden pages, text and hyperlink 
  277. extraction.
  278.  
  279. Vogon is an MSVC 1.52/2.2 application which can be built for either 
  280. 16- or 32-bit platforms. The MFC/C++ source code is available in 
  281. vogonXXx.zip (XXx is the version designation) and may be freely 
  282. modified and distributed.
  283.  
  284.  
  285. MFC/C++ Notes
  286. -------------
  287. Vogon Poetry source code is a starting point for implementing your own
  288. application, with webster.h providing a type-safe interface definition.
  289. A more complete solution for OCX container implementation is promised 
  290. in a future version of MFC.
  291.  
  292.  
  293. Visual Basic 3 Notes
  294. --------------------
  295. The 16-bit webster.dll can be used in VB3 to view local HTML files and
  296. images.  Here is the cookbook:
  297.  
  298. 1.  Insert the MSOLE control into your form (make it a reasonably
  299.     large rectangle).  VB immediately pops up the "Insert Object"
  300.     dialog.
  301.  
  302. 2.  Check "Create New" and select "Webster HTML Control" in the
  303.     "Insert Object" list box.  If you don't see "Webster HTML Control",
  304.     you probably need to register Webster - see the installation 
  305.     instructions.
  306.  
  307. 3.  Click on the resulting control to select it, then hit F4 to bring
  308.     up the "Properties" dialog.  Set the first property, 
  309.     "AutoActivate" to "1 - GetFocus".  All other defaults are OK.
  310.  
  311. 4.   Hit F5 to run.
  312.  
  313. To select a new page programatically, use a statement of the form
  314.  
  315. OLE1.Object.PageURL = "file:///C:/MyPage.htm"
  316.  
  317. ... where OLE1 is your MSOLE control name, and "Object" is constant.  
  318. You can read or write all properties using this syntax -- set the
  319. initial values in Form_Load().
  320.  
  321. The file vb_props.txt lists the available Webster properties and 
  322. methods.
  323.  
  324.  
  325. Trafalmador Software
  326. ====================
  327.  
  328. email:       tanny@netcom.com
  329.  
  330. WWW:         http://www.vpm.com/trafalmador/
  331.  
  332. ftp:         ftp.netcom.com/pub/ta/tanny/
  333.  
  334. -----------------------------------------------------------------------
  335.